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SYNCLAVIER INTERNALS 


Section 1 -- Organization of Sources 


The Synclavier sources are kept in a tree of sub-catalogs. There 
are two primary trees: 


SYNSOU 


Contains Synclavier sources which have been modularized, 
especially including code for the top-level, screen manager, 
sample-to-memory and utilities. 


SYNRSOU 


Contains Synclavier real-time sources which have not yet been 
modularized. 


SYNSOU 


The SYNSOU catalog contains many sub-catalogs which in turn 
contain the XPL source files. The currently defined sub-catalogs 
are: ~ 


DHOMOD — Printer output and hard copy 

DH2MOD - Special output routines for DEC voice box 

DBUGMOD - Sequence debugger code (for internal use only) 

DIRMOD - Synclavier directory screens 

EDITMOD - Sequence editor screen 

ERRMOD - Synclavier error messages 

FILEMOD - File searching code 

GETMOD - Code for get.next.event 

GLOBMOD - Global variables needed everywhere 

GPRMMOD - A set of general buffered disk read routines 

LINKMOD - Miscellaneous routines 

LODMOD - Routines to talk to the direct-to-disk over SCSI 
MATHMOD - High precision math and time conversion routines 
MNOTMOD - Music notation screen 

MONOMOD - Routines for mono sampling playback 

MOUSEMOD - Module for mouse code 

OPTMOD - Optical disk screen 

PARMMOD - Module for processing Synclavier parameters 

PATCHMOD - Sound file patch screen - connects sound files to keys 
PLOTMOD - Plot library 

PMEMMOD = Old (16 bit) poly memory interface, now calls polymod 
POLYMOD - Module with code to access poly memory 

RECMOD - Recorder screen (another sequence editor) 

ROUTMOD ~- MIDI and multi-channel routing display screens 
SCRNMOD - Screen drawing primatives (draw, box, etc...) 

SEQMOD - Sequence manipulation primatives to operate on data str. 
SMGRMOD - Module for screen manager 
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OTHER CATALOGS 


There are several other top-level catalogs which contain files 
needed to compile the Synclavier software: 


SYNRDCLS - External declarations for real-time modules (SYNRSOU) 
SYNAUXS - Auxiliary literals used by only some modules 

SYNLITS - Basie common literals for the Synclavier 

SYNMODS - External declarations for each module in SYNSOU 
SYNMAINS =- Main programs and do files for Synclavier compilations 
SYNCOMS - Compilation’flag sources for different system versions 


me em HM mH 


There are also several catalogs which contain relocatable 
binaries for the Synclavier software: 


# SYNLIBS - Relocatable binaries for each module (from SYNSOU) 

SYNTLIBS - Relocatable binaries for terminal screens (from SYNSOU) 

® SYNRLIBS - Relocatable binaries for Synclavier real-time modules 
(from SYNRSOU) 
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Section 2 -- Internal Memory 


There are several different kinds of memory in a Synclavier 
system. The ABLE computer has memory directly available to the 
processor known as INTERNAL MEMORY. There is additional memory used 
for storing sequences, timbres and other data structures known as 
EXTERNAL MEMORY. A system may also contain POLY MEMORY, used 
primarily for storing sampled sound data. 


* 


OVERALL STRUCTURE 


INTERNAL MEMORY is that which is directly available to the CPU 
for storing instructions and data. Information stored in INTERNAL 
MEMORY is accessible more quickly than other memory in the system. 


‘The 16 bit architecture of the ABLE processor limits the amount of 


INTERNAL MEMORY to 64K words. The structure of INTERNAL MEMORY looks 
like: 


INTERNAL MEMORY 
OA LAR + 
LOC 0 | STARTUP CODE: "PCI TO LOAO" 


C#CONTAB = LOC 1 


! 
i 
i 
PTR TO CONFIG TABLE ooatatats 
ne —) | 
| BALANCE OF STARTUP CODE {| 
(FORMAT DESCRIBED = | ----3-- 93-92 - enn —|j i 
IN :-XPL:SYSLITS) ; CONFIGURATION TABLE [<moo+ 
amram i 
; STRING & DATA CONSTANTS H 
H seach Ties picasa, Sabet: an: foam‘ aebat’ deem» Nami Healt Bama "-acoe Gecig’ Sams ' 
H PROGRAM CODE H 
(SIZE OF LARGEST = | ween neon nnn nnn nnn ~—} 
SWAPPING PROCEDURE) | SWAP AREA { 
try Ore ae eee ne, 1 
VARIABLES : 
ee ! 
STACK i 
| Sreen sorte ersten beeen meee p emt teseeenonanenntenemnren + 
H FREE (*) | NOTE BLOCKS ' 
(TOP-1024) -----= > | torent n nnn nen n enna nena | totter ee nena —|} 
OVERLAY ROUTINE | PARTIAL BLOCKS } 
(TOP 512) -----== > | Set Aen eee { Sanaa enero mmmemanentn + 
| SYSTEM STATE VARIABLES 
(TOP = 60K-1) 60K | ---~--- nnn nnn nnn nn nnn H 
H BOOTLOAD ROM H 
OK 4 enn nnn nnn nnn nnn nn anna n= + 


(*) NOTE: WHEN RUNNING THE SYNCLAVIER PROGRAM, THIS SPACE FOLLOWING THE 


STACK IS USED FOR NOTE BLOCKS AND PARTIAL BLOCKS. THE "OVERLAY 


ROUTINE" IS SWAPPED OUT TO MAKE ADDITIONAL ROOM FOR THEM. THEY ARE 


ALLOCATED AT RUN-TIME OFF OF THE "HEAP" BY THE SYNCLAVIER PROGRAM. 
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If an XPL procedure is declared to be a swapping procedure it is 
not always resident in INTERNAL MEMORY. The compiler automatically 
takes care of allocating a place for it to be loaded in EXTERNAL 
MEMORY. When it is called for execution, it is copied for you to the 
“SWAP AREA" in INTERNAL MEMORY and program control is passed there. 
When another procedure is swapped in to the "SWAP AREA", the previous 
routine is over-written. Only the code is swapped in; the values of 
any static variables are preserved in INTERNAL MEMORY across swaps. 


Most swapping procedures in the Synclavier code are declared to 
be "SWAPABLE" [sic]. This is a literal which translates to 
"RECURSIVE SWAP" for the XPL compiler. It means that variables 
default to AUTOMATIC (created on the: stack) rather than STATIC (in 
internal memory). 


The "SWAP AREA" reserved for a given program is the size of the 
Single largest swapping procedure declared by that program. See the 
section in the XPL manaual on "Swapping Procedures" for more 
information on the subject. 


The Synclavier software is loaded into the PROGRAM CODE and SWAP 

AREA portions of INTERNAL MEMORY for execution. Like any executing 
program, it also uses the STACK and VARIABLES segments. QUEUES of 
pending notes are built in the NOTE BLOCK and PARTIAL BLOCK areas 
which are deseribed in more detail below. 


QUEUES 


NOTE and PARTIAL BLOCK structures for notes which are currently 
active, or will be very soon, need to be in INTERNAL MEMORY for the 
sake of real-time speed of data access. Most of the sequence and 
timbre information is stored in EXTERNAL MEMORY, because it is much 
larger than INTERNAL MEMORY. The Synclavier software looks ahead 
80msec in real time and builds QUEUES of NOTE BLOCKS which in turn 
point to zero to sixteen PARTIAL BLOCKS in INTERNAL MEMORY. 


There are several QUEUES present in INTERNAL MEMORY. Each one 
has a global pointer to the start of the QUEUE which is a linked list 
of NOTE BLOCKS. The currently defined pointers and their QUEUES are: 


NOTELIST -> First NOTE BLOCK in the ACTIVE NOTE LIST QUEUE 
KBDLIST -> First NOTE BLOCK in the NEW KEYBOARD NOTES QUEUE 
SEQLIST -> First NOTE BLOCK in the NEW SEQUENCE NOTES QUEUE 
SEQLAST -> Last NOTE BLOCK in the NEW SEQUENCE NOTES QUEUE 
TIELIST -> First NOTE BLOCK in the TIED NOTES QUEUE 

TIELAST -> Last NOTE BLOCK in the TIED NOTES QUEUE 

NFREEP ~-> First NOTE BLOCK in the FREE NOTE BLOCK LIST 
PFREE -> First PARTIAL BLOCK in the FREE PARTIAL BLOCK LIST 


me Mt Me me eo 
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QUEUE STRUCTURE 
NOTE BLOCK PARTIAL BLOCK PARTIAL BLOCK... 


| PTR TO NEXT NOTE { +>) FORWARD PTR iam} FORWARD PTR 
' BLK IN THIS QUEUE | | [—----------~---=-=~ bf en etetaneteneneenaieetannene 
| coats me ce en teow em ee oad a | OTHER DATA H i OTHER DATA 
1 OTHER DATA eee menaaae, ic Gree ee 
j Sento ease ean a 
: PTR TO PARTIAL BLK {+ i 
| Poet n nee ne enn | pe ne mc a > 
H OTHER DATA _ UP TO SIXTEEN OF THESE 
meaner + PARTIAL BLOCKS MAY EXIST... 

NOTE BLOCKS 


NOTE BLOCKS are allocated and placed on one of the QUEUES just 
described. In order to use the offsets defined for a NOTE BLOCK (eg: 
NFPTR, TIMBRE...), you must set the pointer NPTR to the start of the 
NOTE BLOCK you wish to access. 


NOTE BLOCK (27 WORDS) 


:SYNLITS: QUELITS 
NPTR-->} FORWARD PTR 1 NEPTR 
| TIMBRE NUMBER | TIMBRE 
| TRACK NUMBER | TRACK 
Moe DATA 3 
| RECORDING PTR WORD! RECH 
| RECORDING PTR SECTOR {RECS 


ce caseehmtedaanemetemetenelcanstamtamtemcheatankontendendenstensheeteatentcennantandcantentandunntend 


PARTIAL BLOCK LIST PTR { PTLST 


PARTIAL BLOCKS 


A chain of zero to sixteen PARTIAL BLOCKS are allocated and 
pointed to by the NOTE BLOCK just described. A note may have one to 
four partials by itself. This expands to a maximum of sixteen 
possible PARTIAL BLOCKS when you take the features "chorus" and 
"partial chorus" into consideration. In order to use the offsets 
defined for a PARTIAL BLOCK (eg: PFPTR, PLOG...), you must set the 
pointer PPTR to the start of the PARTIAL BLOCK you wish to access. 
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PPTR-=>} 
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PARTIAL BLOCK (80 WORDS) 
:SYNLITS: QUELITS 


FORWARD PTR 


A CO LO OE FN SOND NE OD SID SSE SOR OE NS ES 


CHORUS PTR 


oe ES A ES SN SS A SD SE CS SE DD 


VOLUME ENVELOPE Q FORW PTR 


A COD NE A NN SD NS SNE CD OD SD ND ND WES ND eNND ND HD SD SED HD HN en RD SD 


VOEUME ENVELOPE Q BACK PTR 


FM ENVELOPE Q BACKWARD PTR 


DECAY FORWARD PTR 


ene OR ED CHR RY DO ORE Ri OO ED A AOD RR A EE OT eR) A ET ce 


=1i= 


| PFPTR 


| PLOG 


| EQF 
EQB 
1 TOF 
: 1QB 
1 FOF 
| FQB 


| GFPTR 
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Section 3 -- External Memory 


External memory is not directly addressable by the ABLE CPU. It 
is accessed as a device is through the use of XPL "read" and "write" 
statements. Because it is addressed using two registers totalling 24 
bits, it is possible to have a maximum of 32 megabytes of external 
memory . 


External memory is divided into SECTORS of 256 words each. Two 
address and two data “registers are used to access it. An address 
register "MAM" gives the sector number (Memory Address 
Most-significant). A second address register "MAL" is an offset into 
the selected sector (Memory Address Least-significant). Once an 
address is specified in "MAM" and "MAL", data (a 16-bit word) is read 
or written from the "MD" register. A fourth register "MDI" may be 
used to access data and auto-increment the MAM and MAL pointers to 
the next seqential word, crossing sector boundries if necessary. 


EXTERNAL MEMORY 
MAM 


MAL = Offset -->} SECTOR-0 (256 words) 


! 
/ SECTOR-1 (256 words) 
i 


0 A EE OE OD NE NN ES OS EE De SE SO SH cD Oc SOND a CO 


H SECTOR-2 (256 words) 


The values of MAM, MAL, MD and MDI are defined in 
:SYNLITS:GLOBLITS. The following example reads the first 1024 words 
of external memory into an array in internal memory, and leaves zeros 
in place of the data in external memory: 


write(MAM) = 0; /* Point at the first sector */ 
write(MAL) = 0; /* No offset into the first sector */ 
do i=0 to 1023; 

array(i) = read(MD); /* Read data word */ 
write(MDI) = 0; /* Clear location and point at next */ 
end; 


OVERALL STRUCTURE 


When the Synclavier program is running, the lower addresses of 
external memory are used to store sequence, timbre and note 
information for the user. Swapping procedures are stored in the 
upper addresses. Swapping procedures are allocated at compile time; 
all other structures shown here are built at run-time. 


The major data structures begin at a pointer, named ???.PTR with 
a length of ???.LEN. Note that the .LEN value is the current length 
of real data stored in that particular area. There is often a "gap" 
maintained at the end of each data structure so new entries can be 
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at. , 


made without shuffling everything around. Usually the largest "gap" 
is kept following the NAH information to allow the sequence to grow 
quickly. As space becomes tight, the gaps are reduced - to zero if 
necessary. 


EXTERNAL MEMORY 


TARR FTE rH ree Reem Ess ee + 
SECTOR 0 | ALL ZEROS H 
BAS, PTR==> | ----2-2-2 22 anna nnn nn 
BAS. LEN 1 SEQUENCE BASE SECTORS (2) j; 
PAR, PTR==> | oman tenen em meemenseneeate men —!. 
PAR.LEN TIMBRE PARAMETER AREA 
NAH, PTR-=> | -<=-=---——~-- =e = 
. H NOTE AREA HEADER (NAH) i 
NAH.LEN !----------- ----! 
. ; TRACK HEADER SECTORS AND ! 
. H NOTE LIST SEGMENTS 1 
° H Pap rt A ent ie Ag ee tee) Se at ey Jee to H 
. H FREE SPACE t 
BNK , PTRe=> | enna annnn nnn nn nnn nnn = 
BNK.LEN H TIMBRE BANK H 
INF. PTR--> | ----~----------------——------- 
INF. LEN | MUSIC PRINTING SEQ INFO jj; 
TIM, PIR--> | ----------------~~---=------- 
‘TIM. LEN i TIMBRE HEADS 1 
TRD, PTR--> | ---------=-~----------------- 
TRD. LEN | TIMBRE TERMINAL DISPLAY INF ; 
EXAMOUNT —=> | -22222-2-nn2nn anne n anne 
MSFIRST==> } MONO SAMPLING BUFFERS H 
MSMA Yann | emanate 
H LOOK UP TABLES { 
' seni mi i SS a i eh ila SS Gl wh ec i sp ig t 
H ALL SWAPPING PROCEDURES i 
sss a a its See ei Tah ca eta esa i 
H RESERVED BY THE SYSTEM H 
a a a aaa a a eae oe aL + 


The next diagram shows the relationship between the track header 
structures. The NOTE AREA HEADER is a single sector containing up to 
256 pointers to TRACK HEADER SECTORS (relative to NAH.PTR). There is 
also a TRACK LOOK UP TABLE in the LOOK UP TABLES area which has the 
same structure, but is 256 absolute pointers to the TRACK HEADER 
SECTORS. 


Each TRACK HEADER SECTOR has several pointers into the NOTE LIST 
SEGMENT for that track. They include pointers to the start of the 
NOTE LIST SEGMENT, to the currently playing note, and to the start 
and end of loops. The individual structures are described in more 
detail later. 
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TRACK HEADER STRUCTURE 


NOTE AREA HEADER or 


TRACK LOOK UP TABLE Resins HEADER SECTOR NOTE LIST SEGMENT 
SRT SE SE RSET REST EE SEER Te eR ee ee + Te ceaia aia mM aa, 
i SECTOR # ee PTR TO NOTE LST SEG{-->} PTR: NEXT NOTE LST | 
nena ap ene eennnemennnmene| 
i SECTOR # H H OTHER DATA i ; PTR: PREV NOTE LST | 
|e Se ee ceeeenanarnens | 
H SECTOR # ' | CURRENT PLAY PTR j{-->; OTHER NOTE DATA i 
| eens mene a ennai —! | ! 
H ‘ - = | OTHER DATA H H . 1 
! ne a ! 
H ° 1 | OVERALL LOOP PTR {==>} e 1 
sonnei a pena 1 ! 
; IND LOOP START PTR {==>} ° H 
H ial alia emir mae sae = i H ° 1 
{| IND LOOP END PTR {==>} . H 
1 aa aaa 1 H e H 
; OTHER DATA i t . H 
panera ena een emcee - , oceania + 


The next diagram shows the relationship between the timbre data 
structures. The TIMBRE LOOK UP TABLE. is a single sector in the LOOK 
UP TABLES area containing up to 256 absolute pointers to TIMBRE 
HEADS. Each TIMBRE HEAD has several pointers into the TIMBRE 
PARAMETER AREA for that timbre. The individual structures are 
described in more detail later. 


TIMBRE STRUCTURE 


TIMBRE LOOK UP TABLE TIMBRE HEAD TIMBRE PARAMETER AREA 
Jgpseserat meses emir isonet + a aniamnaes sn siniaaanpanimaeliiiniaaaiiiatians + 
SECTOR # =>} VOLUME LEVEL i +>] BASIC INFO #1 | 
SS - RETIRES CRLIEReR iments iS oo ccpemamanseraans 
H SECTOR # H | #1 PARTIAL PTR j-+ {| TIMBRE FRAMES #1 | 
fo cromenen enemas f erecta neater EE senaeumineaeiateiae 
i SECTOR # H | #2,3,4 PARTIAL PTR | +>;  PINFO BLOCK #1 
aa aa eecaomaaiae “mre ieacie ceria a annRee laure J Oe pees 
. i i #1 PINFO PTR int | 
; ee |! (ABOVE CAN REPEAT | 
H . H i OTHER DATA H | UP TO FOUR TIMES) | 
a ads +  aceiaaleae ebeevimnriamamansaae i 4 
H MISC PTR im+ | 
Sa eeRe MURA aamamce: TE wesenedneoneemmennes 
TINFO PTR 17>] TINFO BLK 
“aa ea aR Lf 
i OTHER DATA 1 +t MISC AREA 1 
eam fpf erenneceeser nee mmenimeerstsennennans + 
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The following diagrams are an expansion of the previous general 
pictures of external memory data structures. No attempt is made to 
include every piece of data. Rather, the general types of 
information and their relative locations are shown. Pointers to 
other data structures are included so the inter-relationships can be 
seen. 


It is worth noting that many of the pointers used in external 
memory are RELATIVE to a base pointer for the data structure 
containing them. This is so that information in external memory can 
be shuffled around without having to re-caleulate all the pointers. 
Only absolute pointers bécome invalid. 


SEQUENCE BASE SECTORS 


SEQUENCE BASE SECTORS contain miscellaneous information and 
pointers to timbres, notes and music printing. This information and 
the relative pointers are only updated when about to write a sequence 
out to the disk. They are not kept up to date during run time. 


SEQUENCE BASE SECTORS 
:SYNLITS :s THDLITS 


Ad 


. RELATIVE PTR TO BASE SECTOR | SEQ.BAS 
. REL PTR TO TIM PARAM AREA SEQ. PAR 


ee 


i 
i 
' 
BAS.LEN | meee n nnn nnn nen een 
t 


RELATIVE PTR TO NOTE AREA { SEQ.NAH 


OS SE OE a AO SH OE AO ENE NS SD ER SEND WE SI SIC EN SD SY Se HN HO 


1 ! 
| RELATIVE PTR TO MUSIC PRINT | SEQ.INF 


e i * » 


TIMBRE PARAMETER AREA 


The TIMBRE PARAMETER AREA is where the partials are stored for a 
timbre. A timbre can have up to four partials. Each partial starts 
out with a 46 word block (or just a word "SUP" (-2) if the partial is 
not used). Following the 46 word block are some optional blocks of 
data which are variable length. All four partials must be specified, 
or marked unused with "SUP", A good concise example of some code 
which steps through this structure may be found in the procedure 
"FIND. TIMBRE" in the file :SYNRSOU:03-PRIM: 131-SDF1. 
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it is zero, 


TIMBRE PARAMETER AREA 
:SYNLITS: PRMLITS 


PAR. PTR==>4+ 2 AO RC OA SOR OF SI UR Se LE NS EN SS ST + 


46=NUM. PARAMS 


OPTIONAL { 


{ 
TYPE{ 
{ 
CLEN { 


pe i pty pty 


OPTIONAL { 
—, 
cunt 

| { 
{ 


OPTIONAL{ 


PINFO. LEN { 


{ 
OPTIONAL { 
TINFO. LEN { 


Ci 


| BASIC PARTIAL INFO (46 WDS) { 
| OR A SINGLE WORD "SUP" (-2) | 


TIMBRE FRAME (172 WORDS) = | 
8 SYSTEM WORDS 
12 PARAMETERS i 
24 COEFFICIENTS H 
128 WAVE TABLE ENTRIES | 
i 


Ce 
— oom emma 


= se eo ee eee 


—— ee ee ee ele ee 


PARTIAL INFO (32 WORDS) 


NOTE: THE ABOVE REPEATS 4 
TIMES (ONCE PER PARTIAL) 
AND THEN IS FOLLOWED BY: 


NOTE AREA HEADER 


Each pointer is 


Pa® 

t 
NOTE: THERE CAN 
BE MORE THAN ONE 
TIMBRE FRAME OR 


PATCH TIMBRE FRAME 
IN A PARTIAL. 


PL.” 


' 
Tn 


The NOTE AREA HEADER is a single sector containing 256 pointers, 
one for each possible track. 
relative to NAH.PTR, 


a sector number, 


pointing to the track header sector for that 


If there is no active track corresponding to a given pointer, 
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The first two tracks are reserved for the keyboard and 
split keyboard respectively. 
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NOTE AREA HEADER (NAH) 
:SYNLITS: THDLITS 
NAH. PTR——> pon nm men errmmnnn + 
1 


A SE OE ND OD ND HF A RD ane Sn OES EE OO EE OE ON AE See Se ee aD oe SR ee ee a oe 


TRACK HEADER SECTOR 


One TRACK HEADER SECTOR exists for each of the active tracks. It 
is pointed to by the NOTE AREA HEADER data structure. Each TRACK 
HEADER SECTOR is exactly one disk sector in size. The sector 
contains miscellaneous information for the track such as loop and 
play pointers and real-time effects. There is also a pointer to the 
first NOTE LIST SEGMENT which is the first block of actual notes on 
the track. 


' There is a linked list of tracks, sorted by the next event to 
occur in real time. The head of this list is a global pointer, 
"NEXT. EVENT.QUEUE" which points to the TRACK HEADER SECTOR with the 
next up-coming event. Within each TRACK HEADER SECTOR are two 
pointers, THD.NEVF and THD.NEVR which are forward and reverse 
pointers to the next TRACK HEADER SECTORS in this list. As time 
advances, new TRACK HEADER SECTORS are appended to the end of the 
linked list. As an event occurs, the top track is removed from the 
head of the list. 
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TRACK HEADER SECTOR 
:SYNLITS: THDLITS 


THD.FOR (*) 


| REVERSE PTR - ALWAYS ZERO ! THD.REV 
| __TRACK NUMBER ‘mans THD. TRK 
: FORWARD PTR TO NEXT EVENT | THD.NEVF 
| REVERSE PTR TO NEXT EVENT ! THD.NEVR 


TRACK 
THD.WRD (*) 


(PS 8 CO SO OD ONE ED HO CAD DOE C8 ON OD SD HE SE COD ON NN et ON CO RED OR cD cneD Exw DO 


THD.SEC (*) 


MORE DATA FOR 
THIS TRACK 


OVERALL LOOP PTR - WORD # | THD.LP.WRD (*) 
1 


1 
LOOP PLAY PTR - SECTOR # THD.LP.SEC (*) 
MORE DATA FOR 
THIS TRACK 


THD.ILS.WRD (*) 
THD.ILS.SEC (*) 


' 
i 
4 
i 
' 
' 
i 
! 
1 
i 
! 
{ 
1 
i 
i 
' 
ee cc ae a St a ee a : 
MORE DATA FOR H 

THIS TRACK i 

t 

' 

' 

1 

' 

' 

1 

1 

! 

1 

! 

4 

a 


i 

THD.ILE.WRD (*) 
{ 
THD. ILE.SEC (*) 


MORE DATA FOR 
THIS TRACK 


(*) INDICATES A POINTER INTO THE NOTE 
RECORD LIST FOR THIS TRACK 


NOTE LIST SEGMENT 


A NOTE LIST SEGMENT is a linked list of sectors containing note 
records. Each sector contains a forward and reverse pointer and up 
to 126 2-word note records. Special format note records may also 
exist which are 4 words long. Note that the pointers to the first 
and last note records point at actual data. NLS.FIRST and NLS.LAST 
define the size of the block which can POTENTIALLY hold note records. 
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NOTE LIST SEGMENT 
:SYNLITS: THDLITS 


i PTR: NEXT NOTE LIST SEGMENT | NLS.FOR 


LO CN RO LO OY ND A SG OO OE OH OO HS eS en 


| PTR: PREV NOTE LIST SEGMENT | NLS.REV 
TRACK NUMBER | NLS. TRK 
+} PTR 10 FIRST NOTE RECORD | NLS.FP 
oie oar a a of en 
! >| (FIRST) ; NLS.FIRSTL 
: NOTE RECORDS 
| (LAST) | NLS. LAST 
<->! —=s*FLAG AT END (-1) ‘NLS. EOS 
4am acre meee eenen memenamenen emacs ec + 


NOTE RECORDS 


NOTE RECORDS contain information about notes to play, including 
starting time, duration and key to play. They are also used to make 
changes in real-time effects which can effect some or all of the 
currently active notes. 


There are three general rules used in determining the format of a 
NOTE RECORD: 


1. If the LSB of the first word is set, the NOTE RECORD length will 
be 4 words, else it will be 2 words. 


2. If the MSB of the first word is set, the NOTE RECORD is in 
"alternate format", if clear it is in "normal format". When in 
alternate format, the next 4 upper bits of the first word are 
used to indicate what type of "alternate" record it is. 


3. For all 4 word records, the lower 6 bits of the last word must be 
"62" (VEL.NOTE). This is necessary to determine the length of 
the record when stepping through in reverse order. 


A NORMAL FORMAT 2 WORD RECORD is the simplest NOTE RECORD. It 


represents notes in the range of 12 to 72 (C1 to C6). The velocity 
is assumed to be full value (RTE.MAX = 255). 
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NOTE RECORD (NORMAL FORMAT, 2 WORDS) 
:SYNLITS:SYNCLITS 


DATA PRESENT=->{} O;}HI-DUR{START TIME DELTA{O } 
BITS IN FIELD-——>} Alves oo winwisiene TOed wicceisierer led 


i] ] 
{ ! 
; LOW DURATION | KEY NUMB { 
1 ' 
! 1 


Siataleial | Oesinineele ell seeeOee er 


A NORMAL FORMAT 4 WORD RECORD is used to represent keyboard notes 
0 to 84 (CO to C7). The full range of note velocity values may also 
be stored in this record. The duration and starting time fields are 
the same. 


NOTE RECORD (NORMAL FORMAT, 4 WORDS ) 
:SYNLITS:SYNCLITS 


DATA PRESENT==>; O}HI-DUR{START TIME DELTA}1 | 
BITS IN FIELD-=>} Ac cHicwe teeweas LOnekssouwiet ' 
1 


i 

1 t 
LOW DURATION ; KEY NUMB { 

' 

1 


eevee WOiiet seawerepeces seat 


oie a dce é OGing 8's 6 @ tern fae ew Owiecers 


Ce ee AS A MOE ND ED SY SNE SEND SE NE OS SE MOE SANE SS RD CY GD eon OE aE SD eD CS HD ON 


i 
i 
' 
1 
i i 
| SWITCH/FLAG BITS ; RTE DATA ; 
i 
' 
i 
{ 
1 


{ 
VOLUME/OTHER {RAISE/LOW; 62 { 
' 
' 


seco se Oearees |eabereses1ebs 


An EXTENDED REST note record is needed to specify a rest of 
longer than 1023 milliseconds in a single note record. 


NOTE RECORD (ALT FORMAT: EXTENDED REST, 4 WORDS) 


:SYNLITS:SYNCLITS 

SpE ee ae ee Ee OE EE ee ee ee ee + 

DATA PRESENT=->; 1; O {START TIME DELTA;1 | 
BITS IN FIELD-->} Tiss tees lekn san Pciasesaeh let 
| aentemn mene ! 

H MOST SIG START DELTA { 

i baw esd oaic6 ee Oba wine 66 oa edict ' 
re ! 

H LEAST SIG START DELTA H 

H bes eeeoresss Oseice se samen H 

 trameceniciaeeaaeaeaenspee anaiaieneeecncamceaniiiE i 

H UNUSED FIELD 1 62 |} 

i Wun Kase: nd isdeddays tele H 

SpE ee ee Sree Ne ee ee ee oe + 
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An INDEPENDENT LOOP START record is used to mark the start of a 
loop present in this track independent of other tracks. Once a track 
has entered a loop, it will continue playing between the start and 
end loop records without exiting the loop. Only the first word of 
the 4 word record contains any useful data. 


NOTE RECORD (ALT FORMAT: INDEPENDENT LOOP START, 4 WORDS) 


: SYNLITS:SYNCLITS 
aS ee see ee ae eee ae ee ae He eae ee a + 
DATA PRESENT-->; 1} 1 {LOOP START TIME DLT{1 } 
BITS IN FIELD-—>} Ate al bbc kedes oewewdnaka bet 
a a a a a eb anal ' 
1 1 
UNUSED FIELD 1 
{ Pree r rier Te Oe ee re Cree ' 
| | pene enmennneeeeneennnennnnee ! 
i UNUSED FIELD { 
H TET Eee OE CT H 
 eeaiaiceeencmmeatnamemnanranene: i 
H UNUSED FIELD 1 62 | 
! sieied awa ee LUimawe aicinwwmrry Os i 
See eee en ee ee te en ee + 


An INDEPENDENT LOOP END record marks the end of valid note 
records for this track. As time continues to advance, the track will 
loop indefinitely back to the INDEPENDENT LOOP START record. 


NOTE RECORD (ALT FORMAT: INDEPENDENT LOOP END, 4 WORDS) 


:SYNLITS: SYNCLITS 

fe OO ee ee ee ae ee ae ee ee ee ee + 

DATA PRESENT=->{ 1; 2 {LOOP END TIME DELTA{1 | 
BITS IN FIELD~—>} Thelbel sens wwwen Wiewimaveint Vea 
3 oe 
H UNUSED FIELD H 

i steyeusin 6 ee eto lO wala s oo Sie-Sieiee © H 
{ern 

H UNUSED FIELD 1 

i wae seewases lODee ss seecwees H 

panna ntti en nn ! 

i UNUSED FIELD 1 62 | 

' sear Ceses lOsmasceas koaebe ' 

eee nee ee a ee re ee + 


For more information on the exact format of the data in each of 
the above fields, refer to the definitions in :SYNLITS:SYNCLITS or to 
Tim Schaaff's memo "SYNCLAVIER NOTE RECORD FORMATS", 
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TIMBRE BANK 


A TIMBRE BANK is a temporary storage area used to hold a bank of | 
timbres read in from the disk. The format of the TIMBRE BANK is the 
same as the TIMBRE PARAMETER AREA (see earlier description above). 
When the user selects a timbre bank, all the timbres in it are copied 
to this area. Then when a specific timbre is picked, it is copied to 
the TIMBRE PARAMETER AREA. 


If the entire bank will not fit in external memory, the system 
waits for the user to select a specific timbre. Then, that one 
timbre is copied directly from disk to the TIMBRE PARAMETER AREA. 
The size of the TIMBRE BANK is often zero, either because no new 
partials are being selected, or because the space was needed for 
other things (eg: active sequence and partial information). 


MUSIC PRINTING SEQ INFO 


The MUSIC PRINTING SEQUENCE INFORMATION is a block of data which 
is defined by and maintained for the musie printing software. The 
format is considered "unknown" by the Synclavier software. A pointer 
to this block is maintained (INF.PTR) and the data is shuffled around 
to accommodate other areas as necessary. 


TIMBRE HEADS 


The TIMBRE HEADS area is made up of sectors containing 
precomputed information for the basic timbre and pointers to partial 
data in the TIMBRE PARAMETER AREA. All of the pointers into the 
TIMBRE PARAMETER AREA are relative to PAR.PTR. 


The TIMBRE HEADS area may also contain KEYBOARD LOOK UP TABLES. 
These are used when different sounds are mapped to various keys on 
the keyboard (eg: bass drum on middle-C, snare drum on middle-D, 
etc...); this is known as "patching". Each of the four partials for 
a timbre may be patched through a KEYBOARD LOOK UP TABLE, or they may 
not. The pointers in the TIMBRE HEAD are zero if no KEYBOARD LOOK UP 
TABLE exists for a partial; if non-zero they are relative to TIM.PTR. 
In the Synclavier code, sometimes the KEYBOARD LOOK UP TABLES are 
also refered to as the KEYBOARD PATCH LIST. 
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TIMBRE HEAD 


:SYNLITS: TIMLITS 
TIM. PIR--> 42 ennnnn nnn nn nnn nn nn nnn + 
1 VOLUME LEVEL | TIM. VOLUME. LEV 
{wanna naan ! 
H PARTIAL PTRS (4 WORDS) {| TIM.PARTIAL. POINTERS 
i ee a a et ee a a a ee ne oe oe ‘ 
PINFO PTRS (4 WORDS) | TIM.PINFO. POINTERS 
a a a a aa tes es es or moma aie 1 
1 1 
i SYNTH TYPE (4 WORDS) | TIM.SYNTH.TYP 
assesses ce aes v'Gins en sins i i tl es weil ini nc i inl es Di i 
! 1 
| KEYBOARD LOOKUP PTRS (4 WDS){ TIM.KBDTAB. PTR 
1 t 


1 
1 
MISCELLANEOUS AREA PTR {| TIM.MISC. POINTER 
' 
' 


TINFO PTR 


TIM. TINFO. POINTER 


KEYBOARD LOOK UP TABLE 
aie SECTOR; NO LITERALS DEFINED) 


PTR TO PATCH TIMBRE FRAME IN; } THIS REPEATS 
TIMBRE PARAMETER AREA } THREE WORDS 


; 

| ! 

| canner nner ' } PER KEY FROM 
| OIF MONO; 1IF STEREO j; } CO TO C7: 

| ence enna name en nnn nme nen 1} = 85 KEYS 

i PTR TO FILE BLOCK IN i } = 255 WORDS 
| EXTERNAL OR POLY MEMORY j; } TOTAL 

1 


TERMINAL DISPLAY INF 


The TERMINAL DISPLAY INF area is seratch space used by the 
terminal for generating informational displays. An area is 
established to store data matching that which is displayed on the 
screen. Then, as time passes, information inside the Synclavier 
software is compared with the copy of the displayed data. If and 
when the data differs from what is on the screen, the terminal must 
be updated. This way, time only needs to be spent re-drawing parts 
of the display that are out of date. This technique is only one of 
many uses of the TRD area for displays. 
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MONO SAMPLING BUFFERS 


A MONO SAMPLING BUFFER is’ created in external memory to hold 
sound files when they are loaded from disk for the FM synthesizer. 
This block is only created on systems having FM synthesis. The 
format of the data is almost identical to sound files stored in poly 
memory. The MONO SAMPLING BUFFER is created with the smaller of the 
sizes: 


# 158 Sectors. 
# One half of all of external memory from the beginning up to the 
start of the LOOK UP TABLES. 


LOOK UP TABLES 


Some pre-computed LOOK UP TABLES are stored at the top of 
external memory, just under the swapping procedures. These include 
LOG, SINE and FREQUENCY tables. This saves the time of calculating 
the data during real-time Synclavier execution. A number of other 
blocks of information are stored here. Although not expanded further 
in this document, each block is named, shown in its relative position 
in upper external memory and the size in sectors is shown. For more 
information, see the file :SYNRSOU:08-INIT:600-INIT containing the 
procedure "SETUP.EXTERNAL.ALLOCATIONS", 
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LOOK UP TABLES 
MFM.PTR-->{ FM TO MULTI-CHAN MAP (1) { 


' 
MPOLY.PTR-->; POLY TO MULTI-CHAN MAP (1) 
! 


SAF a EN CD SE NE OH HE OA SAE NN SE HE an Ht 


1 
USE. PTR==>} USAGE COUNTERS (1) 


LS mm ED Sh EN I SE HN HN SE NRE NS OD DS 


CLAV.PTR-->; KEYBOARD BITS (1) 


2 SO Se SO SO SE HD OO LD HEY SO AD ETD EE NY CO ON SO NE NS RD mn ORE SN 


TBUT.PTR=~->{ TRACK BUTTON TABLE (1) 
t pall 


A Oe one HRD REED ST CD SY KN A SND EE tC SONY re we EON OD HOM 


' 
PBN.PTR=->{ BUTTON LOOKUP TABLE (2) 


Te oleentninbenrkaneonadancheesonabemntenhenloialiedkamtbenceoncheahimmomatenekemtanntamdantenteondanntend 


' 

t 

‘ 

{ 1 
LOAD.PTR-->; SPACE TO HOLD LOADER (4) |} 
1 

{ 

i] 

! 

1 


' A Le Yo RENE NET ARE NON HE OTH ONY LEE GIR TREY OH CR EE OL MI OE LTS A NN CA ct 


KBD.PTR=->{ PRE-COMP KBD PTL BLKS (47) 
1 


<0 BID Com HE LOND CR ON NE ON OEE OE I NS AO LE OU RS NH SN em I 


NUL, PTR--> NULL TIMBRE (1) | 
IMG.PIR—->} SCREEN IMAGE (4) | 
a ee 
TIMAP.PIR—>} T RANSIT TIME MAP (2) | 
FRE.PIR—>} F REQUENCY TABLE (8) | 
ee aa eel 
LTB.PTR-->! LOG TABLE (4) 


' ' 
1 ' 
i 

TIM.HEAD=->} TIMBRE LOOK UP TABLE (1) j--+ 1st entry 
{ ' ; 
t ' 
1 1 


521 cm ce On HCH CE AN A FORM ON OD RE AE SP ET SE ERE 


' 
1 
TRK.HEAD=->; TRACK LOOK UP TABLE (1) j--+ 1st entry 
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Section 4 -- Poly Memory 


Poly memory is not directly addressable by the ABLE CPU. It is 
accessed as a device is through the use of XPL "read" and "write" 
statements. Because it is addressed using two registers totalling 24 
bits, it is possible to have a maximum of 32 megabytes of poly 
memory. This is in the process of being increased to 28 address bits 
allowing up to 512 megabytes of poly. 


Poly memory is divided into SECTORS of 256 words each. When 
accessing this memory,” the poly system must have the function code 
set to either read or write to poly memory. Then a single data 
register is used to specify the address and data. The data register 
must receive first the sector address, then the offset into the 
sector, and finally the data word(s). Poly memory accesses always 
eause an auto-increment after each one. 


POLY MEMORY 
Be ees eee eee ean + 
Offset -->! SECTOR-0 (256 words) H 


' 


2 CE METS OER SR OID SEF ORD LL CO RI IT OO I ON ON UN 


i 
' SECTOR-1 (256 words) H 
1 


ENS LN EE MD IR AO OND NE INE IE RE eG SD HS DY SO 


1 ! 


wn” 
tI 
QO 
J 
OQ 
7 
Po 
oo 
NM 
Vl 
an 
= 
° 
pt 
o 
a 
~ 


The values of all of the poly memory function codes are defined 
in :SYNLITS:FCODLITS. The following example reads the first 1024 
words of poly memory into an array in internal memory. Note that the 
procedures PSMREAD(MSB,LSB); and PSMWRITE(MSB,LSB); are usually used 
by the Synclavier software to set up the function code and address 
information. This means the first three statements could be replaced 
with "psmread(0,0);". 


write(PSF) = PSRMA; /* Set the poly system to read memory 
write(PSD) = 0; /* Point at the first sector */ 
write(PSD) = 0; /* No offset into the first sector */ 


do i=0 to 1023; 
array(i) = read(PSD); /* Read data word (and increment) */ 
end; 


OVERALL STRUCTURE 


Poly memory is primarily used for storing sound files. It is 
possible to load sound information into poly memory, exit the 
Synclavier program, return later and have the sound files still 
present. They are usually only removed when the space is needed for 
other sound files, on command by the user, or when the system is 
powered down. 
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"/ 


The system is in the process of being expanded to allow multiple 
poly bins to exist. Each one will have a maximum of 32 voices and 
512 megabytes of memory (former maximum was a single bin with 32 
voices and 32 megabytes of memory). Each bin has its own sound files 
loaded in it, and each bin is having data structured as shown below 
for one bin. os 


The first sector of poly memory is used to store a small header. 
The "MAGIC NUMBER" and "REVISION" at the start are zeroed out during 
sensitive transitions (eg: loading a new sound file; shuffling the 
existing sound files around) and restored when they are complete. 
This way, if a user manially aborts the Synclavier program while the 
data structures are in transition, everything must be restored from 
the disk. 


POLY MEMORY BIN 
:SYNLITS:SAMPLITS 


{ 
' 
20 SECTORS 

PSFIRST <-> | --------nn nnn nn nnn nnn nn nnn \<=-FIRST.BASE = 21 
SOUND FILE BLOCKS : 
PSLAST—> | --2—-naannnnn nnn nen nnn nnn nnn 
FREE SPACE 

PSMAX ==> penne nnn nnnn nnn n neem nena nnn +<=-POLYAMOUNT 


POLY HEADER 


The POLY HEADER is stored in the first sector of poly memory. It 
keeps a "MAGIC NUMBER" which means valid data is present if the 
number is preserved. There are also pointers to the other key data 
structures. These pointers are important since the sound file 
information is preserved in poly memory even when the Synclavier 
program is exited. 


The two word pointers (MSB and LSB) are being created to support 


poly bins with greater than 32MB of memory. Older versions of the 
software use single word pointers for PSFIRST through PSHERE. 
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POLY HEADER 
(30071 OCTAL) 
(152077 OCTAL) 


Ae A AD MD GO OO PO ICO HE OD TERE YD Ce SA NE NS Ha 


20 SECTORS 


Between the POLY HEADER and the SOUND FILE BLOCKS, there are 20 
sectors reserved. This is a scratch area used to store a_ sound 
sample that is displayed on the terminal for in-depth analysis. A 
user can examine this sample in detail (eg: mousing through parts of 
it forward, backward, at varying speeds...). 


SOUND FILE BLOCKS 


The rest of poly memory is reserved for SOUND FILE BLOCKS. These 
are data areas of varying length containing the digitized sound 
samples which ean be played back through the poly synthesizer. There 
is one "special" SOUND FILE BLOCK. If the first word of the filename 
is a "1", rather than a printable ASCII character, the block is the 
SOUND FILE CACHE. This is a block of pointers to where all the sound 
files are stored on disk. 
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SOUND FILE BLOCK 
:SYNLITS:SAMPLITS 


BLOCK LENGTH BL.LEN = 0 

| NUMBER OF USERS | BL.USERS = 1 
| FILENAME - 4 WORDS | BL.FNAME = 2 

| *FREE SPACE =! 6 to 19 

| BLK OF DATA MATCHING OFFSETS! BL.KEYTC = 20 to 
IN PATCH TIMBRE (PT.*) | BL.SAVED = 43 

| FREE - REST OF 1ST SECTOR | 4 to 255 

“ONE SECTOR OF FILE HEADER { SF.HDR = 1 

“TWO SECTORS OF SYMBOL TABL 7 = 2 


So 0 0 Ca A OA CE CO CR ES OD CH OR EN EO OND NE DC AR ne Ne NE CE 


1 
! 
' 
{ 
1 
i 
TWO SECTORS OF SYMBOL TABLE | SF.SYM 
! 
| BL.POLY = 1024 
{ 
{ 
i 
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Section 5 -- Hardware Overview 


This is a block diagram of the Synclavier hardware system. The 
direct-to-disk system in the lower right is expanded later on. 
The Synclavier Hardware 
re + 
;External } 
iin: + pone ee i mei de pet ere +<-{ Syne | 
iTerminal; {Mouse} {Guitar and | {Clavier and | !Keyboard | 4-------- + 
prem w en y poeene + }Butt6n Panel} {Button panel! {Analog I/O] +--------- + 
gs i process nnaaa= $ PRT terete een + pomenom ese + | MIDI } 
H H “ % iInterface} 
H  mmcemamemaacaccuicaes: +i i i , aapsipaecie aaa + 
fer reemeeeseereem eee mem moreno mime +14 ir ccaenemiaianeeaas + aig 
itd r 4 , naman inibe: + 4 
pmmenians + vvV vov 1 Vv 
{Modem | Knees n nnn nnn azcsassssssssssssses <p poe oon + +o + 
jena + He He | SMPTE | iExtern | 
meen + HH }1<-->{ Interface |<--- {Devices | 
iExternal ; it ABLE CPU it fone + : en + 
| Memory [<-->11 | Seeeeetee meee emerienn or erewsine eee >not 
1(1=32Mb) } Hn it gereneneeetarentes + Tape} 
Y + 11 (60K + 4K ROM) {{<----->{Floppies} prt t 
it it meena + 
SRSSS SS SSeS SsSssssssca ee en en ss cw ee > A, Neale ies crack! + 
7 ns i iPrinter | 
i I i , areriaiace + 
pa emmennenememameenenan + H — geeeSCSI---+ 
i 1 ! opetrreeemenne + 
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pr mne ne mn ene nn enn | Kenn >! Disk } 
! iPoly Synthesizer | i an + 
4 dlls ieelnalid i pre ecenecaron + 
v iSample-to-Memory | {<---~>j|Winchesters 
, nae. +  Glladaminamvatcteocten aac + 
iFM Synthesizer | ‘Memory (1-32Mb) | H 
ictal maaan arcs + , aaeiadieaiaaacereabicedaaaiiads + Vv 
1 1 i _ anes + 
H Vv Vv H 1Direct-to-Disk | 
: prc ern nnn + H H System H 
H {Multi-Channel | H poet nememarnne seme emeeree + 
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DEVICES AND THEIR ADDRESSES 


The following devices are connected to the ABLE buss to support 
the full configuration shown in the previous diagram: 


D4567 ~- Multiply/divide (really D4,D5,D6,D7) 

D3 —- Real time clock (used to generate 5 msec interrupts) 
Di - Scientific timer (used to generate 1 msec interrupts) 
D2H - SCSI host adaptor 

D30TD - Kennedy 15mb cartridge tape drive 


D32X - Buss extender card containing: 
D32 - Multichannel distributor interface 
DT54-157 - Poly synthesizer interface 


D34 - Guitar and button panel interface 
D40Q - Combined serial port card containing: 
D4O - Printer port 
DHE - Modem port 
BaF - Mouse port 
D50 - Terminal port 


D60 — External memory interface 


DyO = Combined interface address containing: 
D7+(8) - SMPTE interface 
D70=€16) - MIDI interface 


D1IO0A ~ Floppies 
Dt30 - Clavier and button panel interface (velocity keyboard) 


DT60 - FM synthesizer interface 
B60 - Keyboard analog I/O interface (original keyboard only) 


5) HARDWARE OVERVIEW =30= SYNCLAVIER INTERNALS 


DIRECT TO DISK 


The direct-to-disk system connects to the main ABLE computer via 
the SCSI buss. It contains another ABLE computer which is the same 
as the main one except it does not boot from a floppy. The boot ROM 
is modified to receive data from the main ABLE over the SCSI; there 
are no floppies or winchester disks on the "Direct-to-disk ABLE". 


The Direct-to-Disk System 


* 


 anamaies + 
aia + iSound | 
To main ABLE CPU <-----<------ >; DIRECT-TO-DISK {[<---=>jlevel } 
: scsi H ABLE CPU ; MIDI {meter ; 
ne + ibridge} 
4  aeinaiana + 
H 
Vv 
on, pe, gmeiey, , ceidaeaa a raieiambaairt as accel Tet: + 
i Tape {-~ | Disk | -- | Disk |--SCSI-—} tPoly Synthesizer |} 
| nie a Solent a Seta buffer j= = = «= i 
Sia a ceeneie a coe 2 iMemory |Sample-to-Memory | 
iTape {~~ {Diskj-~|Disk{--SCSI--; 2 TS + a i 
FORE NE FENN PE gene i iMemory (1-32Mb) | 
° Nee ee ee ee 4 
e ' 
. Vv 
Up to 8 ft nee + 
pairs of channels H 
each stored on one | AUDIO OUTPUT ; 
or more disks H 1 
Re Sas eee + 
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Appendix 


TERMINOLOGY 


This is a partial list of terms one is likely to encounter when 
reading through the Synclavier code. 


CHANNEL - A voice allocated in a synthesizer. There must be 
a channel available for each individual sound which occurs 
simultaneously. 


EXTERNAL MEMORY =- Memory which is not immediately addressable 
by the ABLE CPU. It is accessed in sectors using 24 address 
bits and therefore may be up to 32 megabytes in size. 
Sequences, timbres and other data is stored here. 


GHOST BLOCK - If a partial block is needed and none are 
available, a search is made to see if there are some decaying 
notes. A GHOST BLOCK is a partial block that is still in 
use, but is for a note which is decaying and will not be 
needed for long. Often, it is better to cut a decaying note 
short rather than avoiding starting a new note on time. 


INTERNAL MEMORY - Memory which is directly available to the 
CPU for instructions and data. Due to the 16-bit ~ 
address space in the processor, it is limited to 64K words. 


LIVE CLICK TRACK - A "metronome" recorded on a track, rather 
"than using the one supplied by the Synclavier. This allows 
for changes in tempo during a song. 


LOOPS - An overall loop may be established to cause all the 
tracks to loop between marked "start" and "end" points. An 
"independent" loop may be set up for a single track. 


MP INFO - Music printing info area; the "INF" section of 
external memory. 


NAH - NOTE AREA HEADER; a data structure in external memory. 
NLS - NOTE LIST SEGMENT; a data structure in external memory. 
ORK - The "ORiginal Keyboard" for the Synclavier II. It is 
the predecessor of the "Velocity Keyboard". It has 61 notes 
(CT te C6}, 
PATCH - When a sound files are divided so that different keys 


or ranges of keys on the keyboard generate sound from 
different samples. 
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PINFO AREA - An optional data area in the TIMBRE PARAMETER 
AREA in external memory. It contains extra partial 
information needed in some cases. 


POLY MEMORY -—- Memory which is part of the poly synthesizer, 
used primarily for storing sampled sound data. This memory 
is also addressed using 24 bits and may be up to 32 megabytes 
long. This is in the process of being increased to 28 bits 
and 512 megabytes. 


RIBBON ~ An effect controller located above the keyboard on 
some systems. As you’ slide your finger back and forth on the 
ribbon, an associated sound parameter can be modified. 


RTE - Real-time effects; selectable from the button panel on 
the keyboard. 


SECTOR - A block of memory or disk storage 256 words (512 
bytes) in size. External memory, poly memory and disks are 
accessed in sectors and 8—bit offsets within sectors. 


TIMBRE - A sound or set of sounds available to be played from 

the keyboard (or guitar). Typical timbres include drums, 
flute, trumpet, vibes... They are often produced from 
several samples of these instruments at different pitches and 
then "patched" together to cover the range of the keyboard. 
Or, in the ease of percussion for example, different 
instruments may be on different keys. Timbres can also be- 
totally synthesized (eg: a sine wave) rather than samples of 
sounds. 


TINFO AREA - An optional data area in the TIMBRE PARAMETER 
ER in external memory. It contains special real-time 
effects information. 


USAGE KEY NUMBER - A checksum generated for a timbre which 
has a VERY VERY high probability of being unique (though not 
100%). Used to identify a timbre to see if it is already 
loaded without having to compare it bit-for-bit. 


VELOCITY KEYBOARD - The current Synclavier keyboard which is 
both velocity and pressure sensitive. It is often refered to 
as the "New Keyboard", It has 76 notes (AO to C7). 


WESTERN SC€ALE - The "standard" 12-tone scale: C, C#, D, D#, 
E ees AF, B. 


VOICE - A channel allocated in a synthesizer. There must be 


a voice available for each individual sound which occurs 
simultaneously. 
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XPL TRICKS 


These are some of the more unusual constructs you will find when 
reading through the Synclavier code. 


*oore(0)" - This can be used as a literal definition, for 
example: 
DCL OVERALL. VOLUME LIT 'CORE(0)'; ~ 

This is sometimes done when a section of code containing a 
literal is conditiohed out, but will not make it through the 
first passes of the compiler without SOME value. core(0) is 
not guaranteed to contain anything useful to most programs, 
so care must be taken not to actually use the value in real 
code. 


FREE.RO; - This is a literal defined to be the (seemingly 
useless) code: 
IF 0 THEN WRITE("300") = READ("300"); 

This statment is optimized out by the third pass of the 
compiler. Its purpose is to trick the XPL compiler into 
thinking that RO ("300") has just been used. Then one can 
write some assembler code like "write("301") = a + b;" to put 
a value into R1 for some extra fast piece of code. Since the 
compiler always allocates registers using RO first, you know 
the addition of a and b will be done in RO, and R1 will be 
free for your use. 


REMINDERS - Sometimes you will see "dead" code like: 
IF POLY.SPLICE THEN DO; END; 
This is put in place as a reminder so that later you can find 
it to put real code in. By removing the literal definition 
of POLY.SPLICE compile errors will be generated if you forget 
to replace one of these constructs with real code. 


RPT nnn; - An XPL literal construct used with the Model-C (or 

“~~ newer) processor only. It causes the next single word 
instruction to be executed nnn times. The execution takes 
place in micro-code as "one instruction cycle" for the 
processor so it is not interruptable! Care should be taken 
not to make these loops too large (usually limited to RPT 
64;). It is FAST though. 


SWAPABLE - A literal defined as "RECURSIVE SWAP". Most 
swapping procedures in the Synclavier source are declared 
with this pseudo-keyword. Note that swapping procedures may 
NOT be ealled during an interrupt. 


REGISTER 13 - The code: 
WRITE("313") = SOMETHING; 
is storing a number directly in register 13. XPL never uses 
R13, so it is available as a very fast variable within a 
procedure. 
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NOTE NAMES 


When notes are stored in the Synclavier software, they are 
generally numbered from 0 to 84 with #36 as "middle-C". This is 
eonvenient since 85 keys is (3 ® 255). The keyboard look up table 
for example is three words per key and fits in one sector of external 
memory. It is also seven full octaves C-C. The keys are named as 
follows: 


NOTES NUMBERED 
€o - BO 0-11 
C1 - Bi 12 = 23 
C2 - B2 24 = 35 
C3 - B3 36 - 47 
C4 = BY 48 - 59 
C5 - BS 60 - 71 
C6 - B6 72 - 83 
C7 84 


Sometimes other designations are used for notes and pitches. 
MIDI uses keys numbered from 1 to 127 where 60 is "middle-C", 


"Pitch class numbers" use numbers of the form "0.SSCC" where "0" 
is the octave (corresponding to the octave numbers in the table 


‘above, eg: A3 is in octave 3), SS is the semi-tone (0 to 11) and CC 


is the number of cents (hundredths of a semi-tone). Using this 
notation, "3.0900" would be "A3" (A at 440 Hz); "3.0000" would be 
"C3" ("iddle-C" or C at 523.3 Hz). 


The original keyboard has a range of 61 notes from C1 to C6. The 
new velocity keyboard is 76 notes from AO to C7. 
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